home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 081-090 / amok89 / cd2oberon / cd2oberon.dok < prev    next >
Text File  |  1993-11-04  |  6KB  |  161 lines

  1.  
  2. Dokumentation zu `Cd2Oberon V1.0' © 1993 Albert Weinert
  3.  
  4. Adresse des Autors
  5. ==================
  6.  
  7. Postanschrift:
  8.  
  9.   Albert Weinert
  10.   Krähenweg 21
  11.   50829 Krähenweg 21
  12.   Germany
  13.  
  14. EMail-Anschrift:
  15.  
  16.   SubNet (InterNet):
  17.  
  18.     aweinert@darkness.gun.de
  19.  
  20.   Z-Netz:
  21.  
  22.     A.WEINERT@DARKNESS.ZER
  23.  
  24.  
  25. Copyright und andere rechtliche Dinge
  26. =====================================
  27.  
  28. Copyright (C) 1992,1993 Albert Weinert
  29.  
  30. Diese Dokumentation darf kopiert und weitergegeben werden solange die
  31. Copyright-Notiz und diese Erlaubnis unverändert auf allen Kopien enthalten
  32. ist.
  33.  
  34. Es wird keine Garantie gegeben, daß die Programme, die in dieser
  35. Dokumentation beschrieben werden, 100%ig zuverlässig sind. Sie benutzen
  36. diese Programme auf eigene Gefahr. Die Autoren können auf *keinen* Fall für
  37. irgendwelche Schäden verantwortlich gemacht werden, die durch die Anwendung
  38. dieser Programme entstehen.
  39.  
  40. Das Paket ist *freely distributable*, aber das Copyright liegt weiterhin bei
  41. Albert Weinert. Dies bedeutet, daß es von jedem kopiert werden darf
  42. solange er nicht mehr als eine angemessene Kopiergebühr dafür verlangt.
  43. Diese Gebühr *darf nicht* höher sein als US $5 oder 5 DM.
  44.  
  45. *Dieses Limit gilt auch für deutsche Public-Domain Händler!!*
  46.  
  47. Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden (CD ROM
  48. Versionen dieser Sammlungen eingeschlossen). Die Distributionsdatei darf in
  49. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses Paket
  50. weitergeben wollen, dann *müssen* Sie die originale Distributionsdatei
  51. `Cd2Oberon_V10.lha' benutzen.
  52.  
  53. Die Programme und der Quelltext (oder Teile davon) dürfen *auf keinen Fall*
  54. auf irgendeiner Maschine benutzt werden, die für die Forschung, Entwicklung,
  55. Konstruktion, Tests oder Produktion von Waffen oder anderen militärischen
  56. Gütern benutzt wird. Dies gilt natürlich auch für alle Maschinen, die für
  57. das Training von Personen in *irgendeiner* der obengenannten Tätigkeiten
  58. benutzt werden.
  59.  
  60. Wenn jemand Änderungen am Quelltext (oder Teile davon) vornimmt, dann
  61. *muss* dieser jemand dem Autor die geänderten Quelltexte und das
  62. Ausführbare Programme und die geänderte Dokumentation zukommen lassen.
  63. Der Autor wird dann daraus eine neue Distributionsdatei machen.
  64. Dies dient dazu eine Versions Hickhack zu vermeiden.
  65.  
  66.  
  67. Wozu das ganze?
  68. ===============
  69.  
  70. `Cd2Oberon' dient dazu aus einer Catalog-Description Datei die man zum
  71. lokalisieren von Programm verwendet in eine Oberon-Module umwandelt
  72. um dieses dann in sein Programm einzubauen.
  73.  
  74. In diesem Modul gibt es zwei Prozeduren
  75.  
  76.   PROCEDURE OpenCatalog*(language:ARRAY OF CHAR);
  77.  
  78.     Hiermit öffnet man den den Catalog in einer gewünschten Sprache.
  79.     Wenn man hier "" übergibt, dann wird die in den Voreinstellungen
  80.     eingstellte Sprache benutzt.
  81.  
  82.   PROCEDURE GetString* (num: LONGINT): e.STRPTR;
  83.  
  84.     Hiermit *muss* man sich die Zeichenketten für sein Programm
  85.     anfordern.
  86.  
  87. Wie diese Prozeduren angewendet werden kann man im QuellText zu dem
  88. Programm sehen.
  89.  
  90. Mit diesem Programm kann keine Kataloge und keine Catalog-Translation
  91. Dateien erstellen. Dazu muss weiterhin `CatComp' oder `MakeCat' verwendet
  92. werden.
  93.  
  94.  
  95. Was hat den Autor dazu bewegt diese Programm zu schreiben?
  96. ==========================================================
  97.  
  98. Als Oberon-Programmierer wird man von Commodore ja reichlich im Stich
  99. gelassen und so erstellt deren Tool `CatComp' nur C und Assmbler Quelltext
  100. ausspuckt kann man damit nur den Catalog erstellen und ihn nicht in seinen
  101. Programm verwenden, was äußerst unpraktisch ist.
  102. Tja, dann gab es noch dieses Programm `MakeCat' von Markt & Technik, welches
  103. dank Kai Bolay ja einen Quelltext für Oberon ausgab. Nur das Programm hatte
  104. diverse Nachteile, es hatte immensviele Enforcerhits, es lies sich nur
  105. über ein GUI bedienen, somit nicht aus MakeFiles herausanwendbar war, und
  106. der erzeugte Quelltext öffnete immer den Katalog in der Sprache die in den
  107. Voreinstellungen eingestellt waren, auch konnte man keine bestimmte Version
  108. anfordern so das man seine Cataloge `kompatibel' halten sollte. Und außerdem
  109. konnte man damit keine Zeichenketten über mehrer Zeilen erstellen. Und dies
  110. waren halt die Gründe es zu schreiben.
  111.  
  112.  
  113. Wie wende ich das Programm denn nun an?
  114. =======================================
  115.  
  116. Das Befehlsmuster von `Cd2Oberon' ist:
  117.  
  118.  CDFILE/A,MODFILE/A,L=LANGUAGE/K,BL=BUILTINLANGUAGE/K,VER=VERSION/K/N
  119.  
  120. CDFILE ist der Name der Catalog-Description Datei
  121.  
  122. MODFILE ist der Named er zu erzeugenden Quelltextes
  123.  
  124. LANGUAGE ist die Sprache in der man den Catalog von `Cd2Oberon' geöffnet,
  125.          diese wird sich nicht auf die QuellText Erzeugung aus.
  126.  
  127. BUILTINLANGUAGE ist die ein Sprache die man in seinem Programm eigebaut hat
  128.                 Voreingestellt ist hier "deutsch".
  129.  
  130. VERSION ist die Versionummer des Catalog den man verwenden will,
  131.         voreingestellt ist hier "0".
  132.  
  133. Ein Beispielaufruf für `Cd2Oberon' sieht dann so aus.
  134.  
  135. > Cd2Oberon TXT/Cd2Oberon.cd TXT/Cd2OberonLocale.mod BL "deutsch" VER 0
  136.  
  137. Aus dem namen der CDFILE wird der Pfad und der Postfix entfernt und daran
  138. ein ".catalog" gehängt. Dies ist dann der Name des Catalogsd er im Quelltext
  139. eingetragen wird. In diesem Beispiel "Cd2Oberon.catalog".
  140.  
  141.  
  142. Was soll noch an dem Programm verbessert werden?
  143. ================================================
  144.  
  145.   - Erstellen von Catalog-Translation Dateien
  146.  
  147.   - Erstellen von Sprach-Katalogen
  148.  
  149.   - Das Module `FileSystem.mod' nicht mehr verwenden
  150.  
  151.  
  152. Sonstiges
  153. =========
  154.  
  155. Hm, es gibt eigentlich hier nichts mehr zu sagen. Für die Anwedung von dem
  156. erzeugten Quelltext schaut man sich den Quelltext zu `Cd2Oberon' an. Dort
  157. wird es benutzt.
  158.  
  159. Viel Spaß wünscht Albert Weinert
  160.  
  161.